Sensor Data Source topic

Use this module to capture, configure, and replay device sensor streams and recorded logs with the Magic Lane Maps SDK for Flutter. It provides a cohesive set of types and services for sampling raw sensors, packaging typed sensor payloads, annotating recordings and controlling recorder and playback lifecycles for telematics, navigation, and activity-tracking use cases.

• SenseData: A canonical container for a single sensor sample or aggregated payload. Use it to carry typed sensor measurements between capture, storage, and UI layers; it holds structured sensor values and metadata about the sample.
• Typed sensor models (for example Acceleration, Attitude, MagneticField, Orientation, RotationRate, Battery, Temperature, GemPosition): Strongly-typed measurement classes.
• Recorder: The primary service that manages capturing sensor streams into persistent logs. Use it to start, pause, and stop recordings and to coordinate sensors, camera capture according to configuration.
• RecorderConfiguration: Configuration object that defines how recordings are performed. Use it to specify which data types to record, storage and chunking behavior, video quality, transport mode and retention rules.
• Playback: Component that replays recorded logs deterministically. Use it to step through recordings, resume/pause playback, and retrieve the latest sample data for visualizations, testing or precise log playback control.
• LogMetadata: High-level descriptor for a recorded session. Use it to inspect start/end timestamps, data availability, transport mode, and other indexing details.
• LogMetrics: Aggregated numeric summary for logs. Use it to surface distance, elevation gain, and average speed in listings and analytics.
• SensorConfiguration and PositionSensorConfiguration: Objects that hold sampling preferences and position-specific tuning. Use these to change sensing behavior.
• CameraConfiguration and camera model classes: Represent camera capture settings paired with sensor streams. Use these when video needs to be synchronized and calibrated with other sensor data.
• RecorderBookmarks: Utility for listing, exporting, and managing saved logs on device. Use it to present recordings to users, import/export logs, and manage lifecycle operations like deletion or protection.
• LogUploader: Upload logs to the Magic Lane servers for bug reporting and analysis
• TextMark, LogMark and related mark classes: Time-stamped annotations attached to logs. Use them to tag events, notes, or markers within recordings for later review.

The Sensor Data Source suite matters because it turns raw device sensors into reliable, reproducible recordings that power navigation, telematics, and analytics features. Its components work together to ensure sampled data is captured consistently, annotated and summarized for quick discovery, and replayed deterministically for testing and visualization. This integrated approach reduces complexity for app developers and improves accuracy and maintainability.

Prefer configuring sensing pipelines with SensorConfiguration and RecorderConfiguration before starting capture so sampling, chunking, and transport rules are deterministic. Start recordings through a single Recorder instance, attach activity metadata or marks as needed, and persist LogMetadata and LogMetrics for quick indexing. Use Playback for review and to drive UI playback controls synchronized with map visualizations.

Learn more about sensors and data sources: https://developer.magiclane.com/docs/flutter/guides/category/positioning--sensors